home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / flop.zip / FLOP.DOC < prev    next >
Text File  |  1991-08-01  |  5KB  |  129 lines
  1.  
  2.                                    FLOP
  3.                                    +*++ 
  4.  
  5.                           File List Output Program
  6.  
  7.                              for Wildcat! 3.0 
  8.  
  9.                    [ requires BRUN40.EXE  in the path ]
  10.  
  11.                       Version 3.04  compiled 8/01/91
  12.  
  13. WHAT IT DOES:
  14. -------------
  15. FLOP examines your ALLFILES.DAT file and produces any combination of up to
  16. 10 output files with information for you and your users.  A handy configu-
  17. ration file will let you specify the pathname, filename, and format of these
  18. output files. Depending on your DOS version, it will allow up to 10,000 files, 
  19. based on available memory.  If you have problems, try making more memory 
  20. available by removing memory resident software.
  21.  
  22. THE OUTPUT:
  23. -----------
  24. You may have FLOP produce any combination of these files:
  25.  
  26. File type 1:  Listing of ALL files
  27. File type 2:  Listing of Password-protected files only
  28. File type 3:  Listing of new files in the past NN days
  29. File type 4:  Listing of Alltime top NN files by download count
  30. File type 5:  Listing of top NN files by download count within past 90 days
  31.  
  32. Up to ten files may be included in the configuration file, as described
  33. below.
  34.  
  35. SETTING UP:
  36. -----------
  37.  
  38. You must configure the program using FLOP.CFG, which is included in this
  39. package.  Use one line for EACH file you want to output.
  40.  
  41. Here's a sample configuration file:
  42.  
  43. c:\wc30\ch_cabin.lst /T1 /F1 /PN /X25
  44. c:\wc30\password.lst /T2 /F3 /PM
  45. c:\wc30\newfiles.lst /T3:30 /F3 /PN /X25
  46. c:\wc30\bull\bull31.bbs /T3:30 /F2 /PN /X25 /COLOR /CLS
  47. c:\wc30\bull\bull32.bbs /T4:20 /F2 /PN /X25 /COLOR /CLS
  48. c:\wc30\bull\bull36.bbs /T5:20 /F2 /PN /X25 /COLOR /CLS
  49.  
  50. List each output file you require on the lines above, with no blank lines.
  51. FLOP will stop looking for filenames on the first blank line or on the first
  52. line that doesn't begin with a valid filename.  Up to 10 output files may
  53. be specified in a single FLOP configuration file ... if more are needed, then
  54. you'll need to have multiple configuration files and use a batch file system
  55. to copy the appropriate one into place for each run.  FLOP always looks for
  56. FLOP.CFG in the current directory when the program is run.
  57.  
  58. Each output file contains a collection of switches which specify the output
  59. format.  Some are required ... some are optional:
  60.  
  61.     c:\wc30\bull\bull6.bbs /T1 /F1 /PM /X25 /COLOR /CLS
  62.  
  63. The first three switches are required for each output file:
  64.  
  65.    /T switch:  (required)
  66.         /T1     Includes all files on the system
  67.         /T2     Includes ONLY files protected with a password
  68.         /T3:dd  Includes ONLY files uploaded within the past dd days
  69.         /T4:nn  Listing of the top nn files by all-time download count 
  70.         /T5:nn  Listing of the top nn files by 90-day download count 
  71.  
  72.  
  73.    /F switch:  (required)
  74.         /F1     One line format  ... file name, size, and description
  75.         /F2     Two line format  ... more information about the file
  76.         /F3     File Info format ... full detailed info about each file
  77.  
  78.    /P switch:  (required)
  79.         /PY     Include files with passwords, and show the password.
  80.         /PM     Include files with passwords, but MASK the password.
  81.         /PN     Don't include files protected with passwords.
  82.  
  83.    /X switch:  (optional)
  84.         /X25,33 Exclude files from areas 25 and 33 in the listing.
  85.                 You may list all file areas to exclude, separated
  86.                 by commas.
  87.  
  88.    /COLOR switch: (optional)
  89.                 If this switch is included, Wildcat! @xx@ color codes
  90.                 will be included in the output file.  Don't use this
  91.                 for downloadable files, but DO use it for display files.
  92.                 Wildcat! will automatically filter these codes out for
  93.                 Non-ANSI-compatible users.
  94.   
  95.    /CLS switch:  (optional)
  96.                 If this switch is included, the @CLS@ control code will
  97.                 be placed at the beginning of the output file.  Wildcat!
  98.                 will clear the screen of your ANSI compatible users.
  99.  
  100. Running the program:
  101. --------------------
  102.  
  103. FLOP will run automatically from a batch file with NO command line
  104. switches required.  Simply be sure that the FLOP.CFG, FILEAREA.DAT, and
  105. MAKEWILD.DAT files are in the CURRENT DIRECTORY when the program is run.
  106.  
  107. If you want FLOP to globally alphabetize your files and not break them
  108. down by file area, invoke the program by typing FLOP GLOBAL on the
  109. command line (or putting it in a batch file.)
  110.  
  111. Problems, questions, suggestions:
  112. ---------------------------------
  113. Please note that this version of FLOP is NOT compatible with Wildcat! 
  114. releases prior to 3.0.  Locate FLOP243.ZIP if you are still using
  115. Wildcat! 2.x.  There is NO version of FLOP for version 1.x of Wildcat!
  116. and none for any of the test drive versions.
  117.  
  118. I welcome suggestions, and will try to help (no guarantees) if there are
  119. problems.
  120.  
  121. You may contact me at The Charlatan's Cabin BBS  (213) 654-7337.  Mention
  122. your Wildcat! registration number in the comment and you'll be upgraded to
  123. membership without the usually required registration by mail.
  124.  
  125. You may also leave a message via CompuServe (70250,220), or on the Mustang
  126. HQ board.
  127.  
  128. ============================================================================
  129.